/**
 * Copyright (C) 2018-2022
 * All rights reserved, Designed By www.yixiang.co
 * 注意：
 * 本软件为www.yixiang.co开发研制
 */
package co.yixiang.modules.mp.service;

import co.yixiang.common.service.BaseService;
import co.yixiang.modules.mp.entity.domain.YxHelp;
import co.yixiang.modules.mp.entity.dto.YxArticleQueryCriteria;
import co.yixiang.modules.mp.entity.dto.YxHelpDto;
import co.yixiang.modules.mp.entity.dto.YxHelpQueryCriteria;
import co.yixiang.modules.mp.entity.vo.YxArticleVo;
import co.yixiang.modules.mp.entity.vo.YxHelpVo;
import me.chanjar.weixin.common.error.WxErrorException;
import org.springframework.data.domain.Pageable;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
import java.util.Map;

/**
 * @author hupeng
 * @date 2020-05-12
 */
public interface YxHelpService extends BaseService<YxHelp> {


    /**
     * 查询数据分页
     * @param criteria 条件
     * @param pageable 分页参数
     * @return Map<String, Object>
     */
    Map<String, Object> queryAllToVo(YxHelpQueryCriteria criteria, Pageable pageable);

    /**
     * 阅读帮助信息
     * @param id
     * @return
     */
    YxHelpVo readHelpVo(Integer id);


    //================================= 后台 ===================================================

    /**
     * 查询数据分页
     * @param criteria 条件
     * @param pageable 分页参数
     * @return Map<String, Object>
     */
    Map<String, Object> queryAll(YxHelpQueryCriteria criteria, Pageable pageable);

    /**
     * 查询所有数据不分页
     * @param criteria 条件参数
     * @return List<YxHelpDto>
     */
    List<YxHelp> queryAll(YxHelpQueryCriteria criteria);

    /**
     * 阅读
     * 查询对应的文章及用户浏览数据
     * @param criteria 条件参数
     * @return List<YxHelpDto>
     */
    YxHelpDto findById(YxHelpQueryCriteria criteria);

    /**
     * 导出数据
     * @param all 待导出的数据
     * @param response /
     * @throws IOException /
     */
    void download(List<YxHelpDto> all, HttpServletResponse response) throws IOException;

    void uploadNews(YxHelpDto helpDto) throws WxErrorException;

    /**
     * 修改
     * @param resources /
     */
    void update(YxHelp resources);

    /**
     * 新增文章
     * @param resources
     * @return
     */
    Object create(YxHelp resources);
}
